from flask import Flask

import os

def create_app(test_config=None):
    # 创建 APP 实例
    app = Flask(__name__, instance_relative_config=True)

    # instance_relative_config=True : 告知 flask 配置文件位置（相对实例文件位置寻找）

    # 设置一些默认配置
    # 密钥、数据库文件位置
    app.config.from_mapping(SECRET_KEY='dev', DATABASE=os.path.join(app.instance_path, 'flaskr.sqlite')) 
    
    # 是否加载测试配置
    if test_config is None:
        # 加载项目根目录下的配置文件
        app.config.from_pyfile('config.py', silent=True) # silent=True : 忽略不存在的配置文件 (不会报错)
    else:
        # 加载测试配置
        app.config.from_mapping(test_config)

    # 确保存放实例的文件夹存在，flask不会自动创建，因为需要创建 SQLite 数据库文件
    try:
        os.makedirs(app.instance_path)
    except OSError:
        pass

    from . import db 
    db.init_app(app)   

    from .auth import bp as auth_bp # 按照该格式进行注册
    if 'auth' not in app.blueprints:
        app.register_blueprint(auth_bp)

    @app.route('/hello')
    def hello():
        return 'Hello, World!'
    
    from .blog import bp as blog_bp
    # 检查是否已注册，避免重复
    if 'blog' not in app.blueprints:
        app.register_blueprint(blog_bp)

    app.add_url_rule('/', endpoint='index') # 添加 URL 规则: 将端点名 index 和 / 关联到一起 -- 这样 url_for('index') 或 url_for('blog.index') 都会生成 / 
    

    return app
